home *** CD-ROM | disk | FTP | other *** search
/ PC World 2007 January / PCWorld_2007-01_cd.bin / v cisle / autoit / autoit-v3.2.0.1-setup.exe / Include / GuiSlider.au3 < prev    next >
Text File  |  2006-07-22  |  11KB  |  220 lines
  1. ; Include Version:1.66 (17 July 2006)
  2. #include-once
  3. #include <SliderConstants.au3>
  4.  
  5. ; ------------------------------------------------------------------------------
  6. ;
  7. ; AutoIt Version: 3.1.1++
  8. ; Language:       English
  9. ; Description:    Functions that assist with Slider Control "Trackbar".
  10. ;
  11. ; ------------------------------------------------------------------------------
  12.  
  13. ; function list
  14. ;===============================================================================
  15. ; _GUICtrlSliderClearTics
  16. ; _GUICtrlSliderGetLineSize
  17. ; _GUICtrlSliderGetNumTics
  18. ; _GUICtrlSliderGetPageSize
  19. ; _GUICtrlSliderGetPos
  20. ; _GUICtrlSliderGetRangeMax
  21. ; _GUICtrlSliderGetRangeMin
  22. ; _GUICtrlSliderSetLineSize
  23. ; _GUICtrlSliderSetPageSize
  24. ; _GUICtrlSliderSetPos
  25. ; _GUICtrlSliderSetTicFreq
  26. ;===============================================================================
  27.  
  28. ;===============================================================================
  29. ;
  30. ; Description:            _GUICtrlSliderClearTics
  31. ; Parameter(s):        $h_slider - handle of the control
  32. ; Requirement:            None
  33. ; Return Value(s):    None
  34. ; User CallTip:        _GUICtrlSliderClearTics($h_slider) Removes the current tick marks from a slider. (required: <GuiSlider.au3>)
  35. ; Author(s):            Gary Frost (custompcs at charter dot net)
  36. ; Note(s):                This does not remove the first and last tick marks, which are created automatically
  37. ;
  38. ;===============================================================================
  39. Func _GUICtrlSliderClearTics($h_slider)
  40.    DllCall("user32.dll", "int", "SendMessage", "hwnd", $h_slider, "int", $TBM_CLEARTICS, "int", 1, "int", 0)
  41. EndFunc   ;==>_GUICtrlSliderClearTics
  42.  
  43. ;===============================================================================
  44. ;
  45. ; Description:            _GUICtrlSliderGetLineSize
  46. ; Parameter(s):        $h_slider - handle of the control
  47. ; Requirement:            None
  48. ; Return Value(s):    Returns value that specifies the line size for the slider.
  49. ; User CallTip:        _GUICtrlSliderGetLineSize($h_slider) Retrieves the number of logical positions the slider moves. (required: <GuiSlider.au3>)
  50. ; Author(s):            Gary Frost (custompcs at charter dot net)
  51. ; Note(s):                Retrieves the number of logical positions the slider moves in response to keyboard input from the arrow keys.
  52. ;                            The logical positions are the integer increments in the slider's range of minimum to maximum slider positions.
  53. ;
  54. ;===============================================================================
  55. Func _GUICtrlSliderGetLineSize($h_slider)
  56.    Local $ret
  57.    $ret = DllCall("user32.dll", "int", "SendMessage", "hwnd", $h_slider, "int", $TBM_GETLINESIZE, "int", 0, "int", 0)
  58.    Return $ret[0]
  59. EndFunc   ;==>_GUICtrlSliderGetLineSize
  60.  
  61. ;===============================================================================
  62. ;
  63. ; Description:            _GUICtrlSliderGetNumTics
  64. ; Parameter(s):        $h_slider - handle of the control
  65. ; Requirement:            None
  66. ; Return Value(s):    If no tick flag is set, it returns 2 for the beginning and ending ticks.
  67. ;                            If $TBS_NOTICKS is set, it returns zero.
  68. ;                            Otherwise, it takes the difference between the range minimum and maximum, divides by the tick frequency, and adds 2.
  69. ; User CallTip:        _GUICtrlSliderGetNumTics($h_slider) Retrieves the number of tick marks from a slider. (required: <GuiSlider.au3>)
  70. ; Author(s):            Gary Frost (custompcs at charter dot net)
  71. ; Note(s):
  72. ;
  73. ;===============================================================================
  74. Func _GUICtrlSliderGetNumTics($h_slider)
  75.    Local $ret
  76.    $ret = DllCall("user32.dll", "int", "SendMessage", "hwnd", $h_slider, "int", $TBM_GETNUMTICS, "int", 0, "int", 0)
  77.    Return $ret[0]
  78. EndFunc   ;==>_GUICtrlSliderGetNumTics
  79.  
  80. ;===============================================================================
  81. ;
  82. ; Description:            _GUICtrlSliderGetPageSize
  83. ; Parameter(s):        $h_slider - handle of the control
  84. ; Requirement:            None
  85. ; Return Value(s):    Returns a value that specifies the page size for the slider.
  86. ; User CallTip:        _GUICtrlSliderGetPageSize($h_slider) Retrieves the number of logical positions the slider moves. (required: <GuiSlider.au3>)
  87. ; Author(s):            Gary Frost (custompcs at charter dot net)
  88. ; Note(s):                Retrieves the number of logical positions the slider moves in response to keyboard input,
  89. ;                            or mouse input, such as clicks in the sliders's channel.
  90. ;                            The logical positions are the integer increments in the slider's range of minimum to maximum slider positions.
  91. ;
  92. ;===============================================================================
  93. Func _GUICtrlSliderGetPageSize($h_slider)
  94.    Local $ret
  95.    $ret = DllCall("user32.dll", "int", "SendMessage", "hwnd", $h_slider, "int", $TBM_GETPAGESIZE, "int", 0, "int", 0)
  96.    Return $ret[0]
  97. EndFunc   ;==>_GUICtrlSliderGetPageSize
  98.  
  99. ;===============================================================================
  100. ;
  101. ; Description:            _GUICtrlSliderGetPos
  102. ; Parameter(s):        $h_slider - handle of the control
  103. ; Requirement:            None
  104. ; Return Value(s):    Returns a value that specifies the logical position of the slider.
  105. ; User CallTip:        _GUICtrlSliderGetPos($h_slider) Retrieves the logical position the slider. (required: <GuiSlider.au3>)
  106. ; Author(s):            Gary Frost (custompcs at charter dot net)
  107. ; Note(s):                
  108. ;
  109. ;===============================================================================
  110. Func _GUICtrlSliderGetPos($h_slider)
  111.    Local $ret
  112.    $ret = DllCall("user32.dll", "int", "SendMessage", "hwnd", $h_slider, "int", $TBM_GETPOS, "int", 0, "int", 0)
  113.    Return $ret[0]
  114. EndFunc  ;==>_GUICtrlSliderGetPos
  115.  
  116. ;===============================================================================
  117. ;
  118. ; Description:            _GUICtrlSliderGetRangeMax
  119. ; Parameter(s):        $h_slider - handle of the control
  120. ; Requirement:            None
  121. ; Return Value(s):    Returns a value that specifies the maximum position in the slider's range of minimum to maximum slider positions.
  122. ; User CallTip:        _GUICtrlSliderGetRangeMax($h_slider) Retrieves the maximum position for the slider. (required: <GuiSlider.au3>)
  123. ; Author(s):            Gary Frost (custompcs at charter dot net)
  124. ; Note(s):
  125. ;
  126. ;===============================================================================
  127. Func _GUICtrlSliderGetRangeMax($h_slider)
  128.    Local $ret
  129.    $ret = DllCall("user32.dll", "int", "SendMessage", "hwnd", $h_slider, "int", $TBM_GETRANGEMAX, "int", 0, "int", 0)
  130.    Return $ret[0]
  131. EndFunc   ;==>_GUICtrlSliderGetRangeMax
  132.  
  133. ;===============================================================================
  134. ;
  135. ; Description:            _GUICtrlSliderGetRangeMin
  136. ; Parameter(s):        $h_slider - handle of the control
  137. ; Requirement:            None
  138. ; Return Value(s):    Returns a value that specifies the minimum position in the slider's range of minimum to maximum slider positions.
  139. ; User CallTip:        _GUICtrlSliderGetRangeMin($h_slider) Retrieves the minimum position for the slider. (required: <GuiSlider.au3>)
  140. ; Author(s):            Gary Frost (custompcs at charter dot net)
  141. ; Note(s):
  142. ;
  143. ;===============================================================================
  144. Func _GUICtrlSliderGetRangeMin($h_slider)
  145.    Local $ret
  146.    $ret = DllCall("user32.dll", "int", "SendMessage", "hwnd", $h_slider, "int", $TBM_GETRANGEMIN, "int", 0, "int", 0)
  147.    Return $ret[0]
  148. EndFunc   ;==>_GUICtrlSliderGetRangeMin
  149.  
  150. ;===============================================================================
  151. ;
  152. ; Description:            _GUICtrlSliderSetLineSize
  153. ; Parameter(s):        $h_slider - handle of the control
  154. ;                            $i_linesize - New line size.
  155. ; Requirement:            None
  156. ; Return Value(s):    Returns a value that specifies the previous line size.
  157. ; User CallTip:        _GUICtrlSliderSetLineSize($h_slider, $i_linesize) Sets the number of logical positions the slider moves. (required: <GuiSlider.au3>)
  158. ; Author(s):            Gary Frost (custompcs at charter dot net)
  159. ; Note(s):                Sets the number of logical positions the slider moves in response to keyboard input from the arrow keys.
  160. ;                            The logical positions are the integer increments in the slider's range of minimum to maximum slider positions.
  161. ;
  162. ;===============================================================================
  163. Func _GUICtrlSliderSetLineSize($h_slider, $i_linesize)
  164.    Local $ret
  165.    $ret = DllCall("user32.dll", "int", "SendMessage", "hwnd", $h_slider, "int", $TBM_SETLINESIZE, "int", 0, "int", $i_linesize)
  166.    Return $ret[0]
  167. EndFunc   ;==>_GUICtrlSliderSetLineSize
  168.  
  169. ;===============================================================================
  170. ;
  171. ; Description:            _GUICtrlSliderSetPageSize
  172. ; Parameter(s):        $h_slider - handle of the control
  173. ;                            $i_pagesize - New page size.
  174. ; Requirement:            None
  175. ; Return Value(s):    Returns a value that specifies the previous page size.
  176. ; User CallTip:        _GUICtrlSliderSetPageSize($h_slider, $i_pagesize) Sets the number of logical positions the slider moves. (required: <GuiSlider.au3>)
  177. ; Author(s):            Gary Frost (custompcs at charter dot net)
  178. ; Note(s):                Sets the number of logical positions the slider moves in response to keyboard input,
  179. ;                            or mouse input, such as clicks in the slider's channel.
  180. ;                            The logical positions are the integer increments in the slider's range of minimum to maximum slider positions.
  181. ;
  182. ;===============================================================================
  183. Func _GUICtrlSliderSetPageSize($h_slider, $i_pagesize)
  184.    Local $ret
  185.    $ret = DllCall("user32.dll", "int", "SendMessage", "hwnd", $h_slider, "int", $TBM_SETPAGESIZE, "int", 0, "int", $i_pagesize)
  186.    Return $ret[0]
  187. EndFunc   ;==>_GUICtrlSliderSetPageSize
  188.  
  189. ;===============================================================================
  190. ;
  191. ; Description:            _GUICtrlSliderSetPos
  192. ; Parameter(s):        $h_slider - handle of the control
  193. ;                            $i_pos - New logical position of the slider.
  194. ; Requirement:            None
  195. ; Return Value(s):    None
  196. ; User CallTip:        _GUICtrlSliderSetPos($h_slider, $i_pos) Sets the current logical position of the slider. (required: <GuiSlider.au3>)
  197. ; Author(s):            Gary Frost (custompcs at charter dot net)
  198. ; Note(s):
  199. ;
  200. ;===============================================================================
  201. Func _GUICtrlSliderSetPos($h_slider, $i_pos)
  202.    DllCall("user32.dll", "int", "SendMessage", "hwnd", $h_slider, "int", $TBM_SETPOS, "int", 1, "int", $i_pos)
  203. EndFunc   ;==>_GUICtrlSliderSetPos
  204.  
  205. ;===============================================================================
  206. ;
  207. ; Description:            _GUICtrlSliderSetTicFreq
  208. ; Parameter(s):        $h_slider - handle of the control
  209. ;                            $i_freq - Frequency of the tick marks.
  210. ; Requirement:            None
  211. ; Return Value(s):    None
  212. ; User CallTip:        _GUICtrlSliderSetTicFreq($h_slider, $i_freq) Sets the interval frequency for tick marks in a slider. (required: <GuiSlider.au3>)
  213. ; Author(s):            Gary Frost (custompcs at charter dot net)
  214. ; Note(s):                The slider must have the $TBS_AUTOTICKS style to use this.
  215. ;
  216. ;===============================================================================
  217. Func _GUICtrlSliderSetTicFreq($h_slider, $i_freq)
  218.    DllCall("user32.dll", "int", "SendMessage", "hwnd", $h_slider, "int", $TBM_SETTICFREQ, "int", $i_freq, "int", 0)
  219. EndFunc   ;==>_GUICtrlSliderSetTicFreq
  220.